LARKEN DISK EDITOR 
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—--- MAIN MENU ---_ . 

Edit data on disk 

Read disk headers 

Change head speed 
Reformat single block 
Initialize Directory 

Map out bad-blocks 

Change disk name 

Cat / Goto drive Now (drvQ) 
Display Track Map 
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LARKEN ELECTRONICS RR#2 NAVAN ONTARIO CANADA K4E-1H9 


The disk editor is a useful tool in modifying repairing or 
examining the Directory , Track map and data on a disk. 

It is supplied on a 48 Tpi S 1/4" disk . If you have a 
different type of drive return it with a blank disk and $2 andi 
will put it on your disk. 


LEDOS DISK ORGANIZATION 

Before you use the Disk editor on a disk, you should have a 
understanding of how the disk is organised and how a program is 
stored on the disk. ‘ 

The disk is divided into Sk Blocks. Each block is comprised of 
10 S12 byte sectors however only the entire block can be 
accessed. 

On a 40 track double sided disk there are 80 blocks. On a 46 
track single sided disk there are 40 blocks. On a Quad (80 trks 
double sided) there are 160 blocks. The blocks are numbered 
starting at track 0 side O (track 0 is the farthest from the 
center of the disk}. Block 1 is track 9%, side 1. All even 
numbered blocks are on side © and all odd numbered bloect:s are on 
side 1 

- Organization of Blocks 
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side 0 Q = 4 6 3 10 12 14 16 #18 =... etc 

Block O is reserved for the Catalog ,Track Map and Disk Name. 
The track map is a 165 byte table beginning at address 2 in 
block QO. The map is used when saving to let the dos know what 
blocks on the disk are available (unused). 

The track map is created according to the number of tracks and 
sides entered when the disk is Formated. Numbers starting from 0 
are listed sequentialy up to a possible 1464 blocks. Any blocks 
that dont exist on the actual disk or are reserved (block O is 
reserved for the catalog),are replaced with the number 245 .The 
dos uses numbers from 245 to 255 as markers in the catalog ) 
eg: If a 40 track single sided disk was formated, the track map 
would show all odd numbered blocks as °245' (used) as well as 
the even number blacks past the 40 track limit. 

When a file is saved the blocks that the file used are replaced 
by 245 in the map. When a file is deleted, the blocks used by 
the file are restored in the map with the block number. If you 
save a file with a name that is already on the disk, the file on 
the disk is first deleted before the new file is resaved. 

Following the Track map are the ‘directory name cells‘. These 
are a list of 100 or so formated areas for storing the file name 
of each file and the blocks used by that file. The length of 


‘@ach cell is 34 bytes but this may vary if the file is custom 


type file. 
Each cell begins with a 255 marker. Then a 9 character file 
name. If the cell is not used or the file has been deleted then 
a 254 marker follows the 255. After the end of the file name is 
a 255 marker marking the begining of the block list used by the 


| 


The end of the block list is marked by a 249. The 249 is a 
floating marker and if the file is deleted it is moved to just 
after the 252 indicating no blocks used. There is room in each 
cell for 21 blocks (over 100K) but this can be expanded for 
segential files etc. On the other hand if you would like more 
than 100 files per disk for a quad drive that has 160 blocks, 
you can reduce the size of the block area so you can put more 
name cells. 

The end of the list of 100 or so name cells is marked by a 250. 
At address 4500 in catalog block is the Disk name. It can be 
very long (over S00 characters) and ends with a Q. 


MARKERS used by LKDOS in Catalog block (block 9) 


can) 


245 - Block in use . Only used in track map. 
249 Marks the end of the block list in name cell 


250 —- Marks the end of the Directory Name Cells 

253 - Marks the beginning of the block list in name cell 
2u4 - Follows the 255 if the cell is not used. 

230 - Marks the beginning of each Directory Name Cell 


- Also in block 0, address 20 holds the number of sides on the 
disk, address 21 holds number of tracks , and address 22 holds 
the head speed (Head speed is the speed that the disk drives 
head steps from track to track.) 


DATA BLOCKS 

All. blocks from block 1 up to the max on the disk are data 
blocks. Each data block contains a 24 byte information header 
and then room for 5090 bytes or data. 
The header is as follows. 


Address in block Descripion 
Qa reserved 
1 block number 
2- il File name of data on block 
12,12 Start address of file 
14,15 ; lenth of data on block only 
15 sum check (CRC) number 
17,18 Auta start line # for Hasic 
20,21 Variable - Frog (Ofset for Basic) 
2eyeu Total Length of file. 
24 Start of DATA (S090 bytes max) 


DISK EDITOR COMMANDS : 

When using the disk editor you should have the write protect 
sticker removed from the disk you want to edit or modify. The 
routines used in the Disk editor cannot detect the presents of a 
write protect sticker. 

1) EDIT data on Disk 

Selecting this will display a windowed screen with a prompt to 
enter a block number to load into the buffer. You can view or 
edit the directory block by entering block 9, or other numbers 
for data blocks. If you enter ‘n’ you can enter the edit mode 
with out loading a block. F 

Press Enter to scroll the screen or the space bar to single 
step through the buffer. 

The bar across the left side of the screen is the address of 
the line that can be edited. Press ‘n’ to enter a new number , 
‘ce’ to enter a character or entire character string or filehame. 

To go to a new address in the buffer press ‘'g’' then the address 
. You cannot go beyand the limits of the buffer. The buffer 
starts at S0000 , sa if you want to go to the 4500'th address in 
the butfer to see the Disk name then enter 54500. 

Pressing ‘f’ will let you search for_a byte (such as the next, 
[55 marker) or a character (enter CODE "X"). 

To save the buffer back to the disk press ‘s’. You can load a 
block or catalog from one disk and then save it to another disk. 

To exit to the main menu press ‘q’- 
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(2) Read Disk Headers 

This will print to screen or printer all the data headers of 
all the data tracks. This is useful if you want to find the 
start and length of a code file or to find the blocks used by 
files when you are reconstructing a damaged directory. 
The printer option prints to 2040 printer unless you 
Open #3,"lp" or load a printer driver. 


(3) Change Disk Speed 
This allows changing the head speed on a disk to a different 
value. Enter ‘4° to abort changing. 


(4) Reformat Single Black 

A block can be damaged by accidently turning the power = on 
to the drive with the disk in it, Or numerous other ways. You 
can reformat a single block using this opion. Since the format 
code is the only code that can only be used on a “specific 
interface, you must insert the Disk Editor disk and load the 
Format code before actually formatting. After the code has been 
loaded once though, you can enter ‘z’ to ignore repeated loading 
-of the format code. 


(S) Initialize Directory : 
With this you can init the directoy and track map but not 
change the Disk name. Warning- This will wipe out all files! 


(5) Map out Bad Blocks 

A disk that has bad blocks caused by a scratch or other 
Physical defect can have them automatically mapped as ‘unuse’ by 
this command. However you should be certain that the reason for 
the cre errors is the disk, and not the drives or some other 
hardware problem. ; 
A disk that makes a click when it is rotating in the drive 
usually has a surface defect. 


(7) Change Disk Name 

You can change the disk name without altering any thing else 
on the disk using this option. 
You could even break the program and load the disk name from « 
word processer file to address 54500 ,then save the buffer. 
Tasword cant be used because it formats each line as 44 
characters. Mscript works good though. 


(8) Catalog / Goto Drive (Now ©) 
This allows you to change drives and display the catalog. If 
you dont want to change drives, just press enter. 


(9) Display Track Map 

This lets you see a graphic representation of the Track 
Map. The vertical numbers represent ‘tens’ and the horizontal 
numbers are ‘ones’. This gives you a picture of the state of the 
disk. If a lot of files have been deleted you will see How the 
dos keeps track of unused tracks. 


Note —- You can break and alter the program as you wish. Its Ok 
to RUN it. Most of option 1 (the editor) runs as compiled Basic 
(compiled with Time Machine at 60000) - The compiled section 
begins at line 910 and ends at 1450. 


LKDOS MACHINE LANGUAGE SUBROUTINES 
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The following information is for directly using the routines 
within the dos to control the disk-drive. 

They are useful in examining or changing data on the disk and 
rene you can create custom files and simulate random access 

iles etc. ; 


To access dos subroutines within the cartridge directly you 
must use machine language. 

To call these subroutines you must first turn ON the cartridge 
with a Call to address 98(dec). The cartridge is turned OFF by 
a memory read at address 100(dec). 

You should also disable the interupts before entering and en- 
able them after you are done. 

EG: to access the cartridge. DI 

CALL 98 

CALL dos subroutine 
other user code 

LD A, (100) 

EI 

RET 

DESCRIPTION OF USEFUL SUBROUTINES 

The addresses of these subroutines are on the following pages 
The jump table of calls is used so that the addresses of the 
main routines doesn’t change when a change or revision is made 
to the LKdos Eprom. Also because of the size of the dos, it was 
assembled in 2 modules . The second module uses the table to 
link to the first module. 

SAVERF - Saves buffer to the current track and side as setup 
by TRACK or NEXTR. Disk should be spinning for 1 second before 
using this routine. You can load data to and from the buffer 
using the LDIR command in machine language. 


LCADBF —- Loads the buffer from the current track and side. 
No spinup necessary. 
TRACK - Restores the drive head to track 0, then seeks the 


track held in curtrk. The number in curtrk is actually the 
block number. Even blocks are side 0, Odd are side 1. The | 
track# is = INT(block/2)} EG: Block 11 = track S side 1. 
Track also dces the 1 second spinup required by save and load 
routines. It should be the first call in any disk access. 
Thesteta inthe buffer may be emeeed -by the TRAEK combine so 
4m—the—beuffer—_after 


NEXTR - Increments curtrk by one and moves the head to the 
sees Pee or side . The drive should be running before this is 
called. 

INDIR - Sets the head on trackO and loads the directory trk 
Then searches for a file name matching the one the user has put 
at prognm. The temp2 pointer holds the address of the file name 
if found. Errnu will contain 10 if the file wasn’t found. Clear 
errnu before calling this. The file name should be put at 
prognm before calling this with spaces following the name to a 
full 10 characters if the name is short. 

WFROT - Does 3/4 secend spinup then checks for write protect 
sticker. If found it prints an error. This routine will stop 
your program on an error. Better to check it manually. 

DECDP — Prints decimal # held in tempi and accumulator. 

DOSER - This will print a standard type Error the same way 
that the 2068 does. The HL register should hold the address of 
the arror message and the message should end with a period °.”— 

eVALU - This is used to evalute a Basic Numeric Expression in 

a Pasic Command. ‘CHADD’ should point to the start of the. 
number or formula. Use RST #20 to move CHADD. The result will 
be returned in the BC register. Evalu uses the Sinclair Rom 
calls ta do this very complicated math. It checks to see if you 
are in 2068 or Spec mode then does the appropriat rom call. 
BTFIL - This is like EVALU but is for string expressions. 
Phadd should point to one Character before the string before 
calling GTFIL. The result string will be in Frognm . The DE 
register will point to a Quote ‘"’ at the end of the string. 

If you are going te search for that file with INDIR, then 
replace the Quote with a space by -— LD A,S2 LD (DE) ,A right 
after calling GTFIL. 


Lf 


SAVING AND LOADING PROGRAMS FROM MACHINE CODE 

You can directly access the main cperating system by the ; 
following 4 subroutines. This will allow you to write or modify 
fully machine code programs to use the disk just as you can in 
basic. Due to the compexity of saving and loading BASIC or ARRAY 
files (due to memory and variable shuffling) only loading 
and saving Code files will be described here. 

When you send the Lkdos a command in BASIC, the dos scans the 
line for the info it needs. But in Machine code we must put the 
information in certain locations then call the dos to use it. 

The dos location ‘NmiF‘’ is used to tell the-dos how it is 
being called (NMI, Basic or from a machine code program). It 
should be loaded with 1li(dec) before you call the fGllowing 
routines. 

SAVING FILES from MACHINE CODE 

To Save an area of memory to disk from MC, you must give it a 
file name and transfer the file name to prognm. The file name 
should be a Code type but since there is no syntax checking, 
any name and extension will work. You are not limited to .A EH 
or .C typefiles. 

Then call the SV#1 subroutine. This will enter the file name 
in the directory and fill the dir workarea with free blocks to 
use for saving. If the file already exists then the old file is 
deleted first. 

Now load temp2 with the length of the file and temp4 with the 
start address of the file. Then call SV#2 to finish the save. 
EG: to save a file named ‘test.ZZ’ start Adr 30000 length 10600 


Save DI : disable int. 
CALL 98 turn on cartridge. 
LD HL,Name transfer file name 
LD DE,prognm to prognm 
LD BC,10 
LDIR 
LD A,11 Set MC save. 
LD (NmiF) ,A , 
CALL SV#1 Save name . 
LD HL,20000 
LD (temp4) ,HL Set start address. 
LD HL,10000 _ * 

- LD (temp?) ,HL Set length of save. 

CALL SV#2 Second data 
LD A, (100) Exit cartridge 
EI 
RET 

Name DEFM /test.2ZZ / Name of file.Spaced out to 


10 characters 


The SV#1 mainroutine first calls the WPROT subroutine to see 
if the disk is protected. If it is,then it will terminate with 
a_error. This will stop a MC program. 

If you dont want your MC program to be stopped the best way 
around this is to find the address of the actual SV#1 routine 
in the eprom by reading locations 205 and 206 then adding 3 to 
this to get past the WPROT call,then Calling this new address 
directly. This address must be calculated dynamicly because it 
may change with new revisions of eproms. 

Tf you are saving a file from one address but you want the 
files absolute load address (eg LOAD "file"CODE —- no addr 
specified) then you should change the locations ‘Destin’ and 
‘Totlen’ on the first block of the file to reflect the new start 
or length. Also if you are adding data to the end of a file such 
aS 1n sequenial files, you must update ‘Totlen’ on the first 
block of the file. 

If the file is a BASIC or ARRAY file, the first and last blocks 
should have there pointers updated. 


LOADING A FILE FROM DISK Lone : 
Loading a file from MC is similar to saving. 
instead of SV#1 and LD#2 instead of SV#=2. 
still go into temp4 and temp2. 
place the same way. 

If you want to use the start address and length that the file 
was saved from to load it, then after calling LD#1 (the first 
block of the file is now in the buffer), use the Destin and 
Totlen pointers as your start and length. 

You can poke 23728,100 the same way as a basic load, so that 
you dont halt your program with a File Not Found error. 


SELECTING DRIVES from MC 
The dos variable Dvsel specifies which drive is the current 


Just use LD#1 
The start and length 
The file name is also moved into 


drive . 1 = drvo 
2 = drvi 
4 = drv2 
9 = drvs 
128 = drv4 (Ramdisk) 


When changing drives (especially floppys) insert a .OS second 
delay before and after changing drives between any disk call. 


MACHINE CODE PROGRAMING GUIDELINES FOR LKDOS 
If you plan on writing a program for your self or other Lkdos 
users, to be fully compatible with. other programs or changes i 
may make the following simple rules should be followed . 

- Using the calls to the jump table in the cartridge will keep 
compatibility among users of different interfaces (Aerco ramex 
etc.) Dont use the format code that is supplied with the format 
program. . 

~- When searching through the directory track always use a 
linear search starting at the start of the track map and search 
byte by byte. Never expect the length of the track map to always 
be 165 bytes long or the offset between name cells to be 


exactly 34 bytes. These can change and are designed to be 
changeable. 


A SAMPLE MACHINE CODE PROGRAM 


FREE BLOCKS 

This routine allows you to find the number of free blocks with 
out displaying the catalog. 

It will return the number of free blocks in the BC register, 


so it can be accessed from basic with FRINT USR FREERL or 
LET »x=USR FREERL . : 


00010 FREERBL DI 


a0020 CALL 98 - turn on the Lkdos cartridge 

90030 LD A,O 

00040 LD (curtrk),A —- move the disk drive to 

00050 CALL TRACE - block O (side 9 track 9) 

00060 CALL LOADRBF —- load disk to buffer 

00070 LD C,0 - set counter to 0 

90080 LD HL,data —- set HL to start of track—-map 

oo090 USED INC HL - first block always used anyway 
Q0100 LD A, (HL) 

oo11a CP 255 - 2755 marker means ‘end of track-map 
00120 JR Z,EXIT - if so then exit 

00130 P 245 —- 245 marker means ‘block used’ 
q0140 JR Z,USED - if used then move on to next one 
oo1se] INC C —~ must be a free block,update count 
00160 JR USED —- continue searching for free blocks 
oo170 EXIT LD B,o 

00180 LD A, (100) - turn cartridge off 

00190 EI 

00200 RET 


@ 


LKDOS ADDRESSES AND SUBROUTINES FOR USER PROGRAMS 


DQOOLO HERE HEHEHE EE EEE EEE EHH EEE EHH EEE REE EH 


00020 LOCATIONS USED BY THE DOS CALLS 
DOO4O HEHEHE RHE HEHEHE HEHEHE HEHEHE HEE HEHEHE HE 


O0050 NmiF EQU 8194 Nmi,User or Basic Flag 
00060 Dvsel EQU 8195 Drive select byte (1770) 
90070 Hspd EQU 8202 Head speed for FD1770 
00080 Rbank EBU 8203 Ram Disk bank# 
OC690 Raddr EQU 8204 Ram Disk bank address 
00095 Chars EQU 8218 Addr of Window CharSet—-256 
00100 wrkspce EQU 9220 Start of Disk workspace 
00110 buffer EQU wrkspc +84 Start of track buffer 
00120 data EQU buffer +2 Start of Actual data block 
00130 curtrk EQU wrkspc +1 Block # for head to seek 
001234 errnu EQU wrkspce +4 Q if no error occured 
00135 prognm EQU wrkspc +4 Holds string from GTfil 
00140 tempi EQU wrkspce +20 Used by DECDMP 
00150 temp2 EQU wrkspe +21 Usually length of file 
00160 temp4 EQU wrkspce +25 Start address of file 
90170 tempd EQU wrkspce +25 temperary address 
Q0175 dirwka EQU wrkspe +30 Holds Cell being used 
**##*" These are registers are saved with each track **** 
00180 destin EQU buffer +12 address of data block 
00190 lenth EQU buffer +14 lenth of data block 
00200 Linenu EQU buffer +17 Auto start Basic Line 
00210 Vofset EQU buffer +20 Vars Offset (Vars-—-Prog) 
Q0220 Totlen EQU buffer +22 Total lenth of file 
HHH HEHEHE HEH EHH HEE EHH HEHEHE EE EHH HEHEHE RHEE EERE HEHEHE 
Bufferlength Data length 

3114 3990 Std Double Density Controller 

1994 1950 Old Single Density Controller 


HE EH HEHEHE HEE HEHE HEE HEE HIER HEHEHE HEHEHE HEHE EE 
This is the Lkdos main subroutine jump table . Each Call 
is 3 bytes apart. These addresses are unaffected by any 


Changes or revisions made later to the Dos. : 
QODTO HEH KHHEEEKEEHKEREREE 


GO260 STARTS AT ADDRESS 120 (decimal) 

00270 --— CALL---------- ADDRESS 

QOO280 SAVERF JP crcsv 120 Save the buffer to the disk 
GO0290 LOADBF JF loadbf es Load the Buffer from the disk 
Q0S300 TRACK JP trac 12 Restore to TrkO then seek curtrk 
QOS10 NEXTR JP nextrk 129 Increment disk head 1 trk or sid 
90320 INDIR JP indir 132 Check dir for file (in prognm) 
00230 MOVDR JP movdr 135 Move cell to dirwka 

00340 CMDCK JP cmdck 1298 Check command syntax 

QOO350 ENDLN JP Endoln 141 Move CHADD to end of basic line 
90360 EVALU JP Evalu 144 Evaluate Numeric formula 

00370 NOFIL JP nofil 147 No file error 

O0380 WPROT JP WPROt 150 Check for protect sticker 

00390 ZERO JP zer0O 153 Restore blocks used by cell 
00400 GTFIL JF GTfil 15 Evaluate String , Put in prognm 
00419 ROMM JP ROMS 15 Check for spectrum rom 

00420 NEWET JF newet 162 Put new entry in dir 

00420 DECDP JP decdmp 145 Print temp1 in decimal 

00440 TRANOK JP tranok 168 Final routine for save 

00450 DOScp JP DOSOF 171 Close the disk channel 

00460 DOSER JF Doserr 174 Frint Error. HL holds Messag 
00470 CLREF JF clirbf 177 Clear buffer 

O0480 ENCOD JP encdb¢ 180 Encode the buffer with Addresses 
00490 VSERCH JP vserch 183 Look for Arrays 

QO500 JPOUT JP GTOUT 1846 Exit cartridge 

00510 GROW JP Grow 139 Insert Space in program 

OOS20 SHrnk JF Shrink 192 delete space in program 

OGS20 DTERR JP Fatal 195 Cat data error 

00540 LD#1 JP Lsubr 198 First half of User load command 
00550 LD#2 JP LDdata 201 second half 

90560 SV#1 JP Ssubr 2O4 First half of User save command 
00570 SV#2 JF SMEM 207 second half 


NOTE- Most of the cartridge ram is used by the dos and ex—-bas 
operating system, But the merge buffer can be used for temp 
storage . It follows the data buffer and is 1200 bytes long. 
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